REST API

HTTP를 직접 사용하는 방식으로, SDK 설치 없이 모든 언어와 환경에서 즉시 사용할 수 있습니다.
curl, Go, Java, PHP, Ruby 등 HTTP 요청이 가능한 환경이라면 어디서든 연동 가능합니다.

엔드포인트

POST https://ai-api.iwinv.kr/v1/chat/completions

요청 헤더

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

기본 요청

cURL

curl https://ai-api.iwinv.kr/v1/chat/completions \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [
      {"role": "system", "content": "당신은 친절한 AI 어시스턴트입니다."},
      {"role": "user", "content": "안녕하세요!"}
    ],
    "max_tokens": 512,
    "temperature": 0.7
  }'

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "model": "gemma4-26b",
        "messages": []map[string]string{
            {"role": "system", "content": "당신은 친절한 AI 어시스턴트입니다."},
            {"role": "user", "content": "안녕하세요!"},
        },
        "max_tokens": 512,
    })

    req, _ := http.NewRequest("POST",
        "https://ai-api.iwinv.kr/v1/chat/completions",
        bytes.NewBuffer(body),
    )
    req.Header.Set("Authorization", "Bearer "+os.Getenv("IWINV_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class IwinvAPI {
    public static void main(String[] args) throws Exception {
        String apiKey = System.getenv("IWINV_API_KEY");
        String body = """
            {
              "model": "gemma4-26b",
              "messages": [
                {"role": "system", "content": "당신은 친절한 AI 어시스턴트입니다."},
                {"role": "user", "content": "안녕하세요!"}
              ],
              "max_tokens": 512
            }
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://ai-api.iwinv.kr/v1/chat/completions"))
            .header("Authorization", "Bearer " + apiKey)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP

<?php
$apiKey = getenv('IWINV_API_KEY');
$data = [
    'model' => 'gemma4-26b',
    'messages' => [
        ['role' => 'system', 'content' => '당신은 친절한 AI 어시스턴트입니다.'],
        ['role' => 'user', 'content' => '안녕하세요!']
    ],
    'max_tokens' => 512,
    'temperature' => 0.7
];

$ch = curl_init('https://ai-api.iwinv.kr/v1/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'];

응답 형식

{
  "id": "chatcmpl-xxxxxxxxxxxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gemma4-26b",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "안녕하세요! 무엇을 도와드릴까요?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 15,
    "total_tokens": 35
  }
}

스트리밍 응답

stream: true 설정 시 Server-Sent Events(SSE) 형식으로 토큰을 실시간 수신합니다.

cURL

curl https://ai-api.iwinv.kr/v1/chat/completions \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [{"role": "user", "content": "iwinv를 소개해주세요."}],
    "stream": true
  }'

Go

// stream: true 추가 후 응답을 라인 단위로 읽기
body, _ := json.Marshal(map[string]interface{}{
    "model":    "gemma4-26b",
    "messages": []map[string]string{{"role": "user", "content": "iwinv를 소개해주세요."}},
    "stream":   true,
})

req, _ := http.NewRequest("POST",
    "https://ai-api.iwinv.kr/v1/chat/completions",
    bytes.NewBuffer(body),
)
req.Header.Set("Authorization", "Bearer "+os.Getenv("IWINV_API_KEY"))
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

scanner := bufio.NewScanner(resp.Body)
for scanner.Scan() {
    line := scanner.Text()
    if strings.HasPrefix(line, "data: ") {
        fmt.Println(line)
    }
}

스트리밍 응답은 아래 형식으로 청크 단위로 전달됩니다.

data: {"id":"...","choices":[{"delta":{"content":"안녕"},"index":0}]}
data: {"id":"...","choices":[{"delta":{"content":"하세요"},"index":0}]}
data: [DONE]

임베딩 요청

curl https://ai-api.iwinv.kr/v1/embeddings \
  -H "Authorization: Bearer $IWINV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-large",
    "input": "iwinv 클라우드 서비스 소개"
  }'